Skip to content

feat(www): SEO & AEO audit improvements#89

Open
bholmesdev wants to merge 1 commit intomainfrom
seo-aeo-audit
Open

feat(www): SEO & AEO audit improvements#89
bholmesdev wants to merge 1 commit intomainfrom
seo-aeo-audit

Conversation

@bholmesdev
Copy link
Owner

@bholmesdev bholmesdev commented Mar 5, 2026

SEO & AEO Audit Fixes

This PR addresses several SEO and AEO (Answer Engine Optimization) issues found during an audit of the www documentation site.

Critical Fixes

  • Add site URL to astro.config.mjs — enables canonical URLs, sitemap generation (via Starlight's built-in @astrojs/sitemap), and proper absolute URLs in OG/Twitter meta tags
  • Add robots.txt — guides crawlers and points to the generated sitemap

High Priority Fixes

  • Add WebSite + Person JSON-LD structured data site-wide via Starlight's head config — improves search engine understanding and AI engine discoverability
  • Add og:type meta tag — ensures proper Open Graph typing for social shares

Medium Priority Fixes

  • Mark deprecated pages as noindex — Stream and Form pages (4 total) are deprecated and now have <meta name="robots" content="noindex, follow"> to preserve crawl budget
  • Remove redundant custom title override on homepage — the head tag was overriding Starlight's default title behavior
  • Add title attribute to video element in stream.md for accessibility and SEO

What Starlight Already Handles

  • Meta descriptions from frontmatter ✅
  • Proper heading hierarchy (single H1) ✅
  • Responsive viewport ✅
  • OG title, description, URL, locale ✅
  • Twitter card meta ✅
  • lang="en" on <html>
  • Canonical URLs (now that site is set) ✅
  • Sitemap generation (now that site is set) ✅

Build Verification

Verified with astro check && astro build — 0 errors, 0 warnings.


This PR was generated with Oz.

@changeset-bot
Copy link

changeset-bot bot commented Mar 5, 2026

⚠️ No Changeset found

Latest commit: 23c3b6d

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@vercel
Copy link

vercel bot commented Mar 5, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
simple-stack-docs Ready Ready Preview, Comment Mar 19, 2026 9:05am

@bholmesdev bholmesdev changed the title feat(www): SEO & AEO audit — sitemap, robots.txt, structured data, improved meta SEO/AEO audit: add site URL, robots.txt, structured data, and improved meta descriptions Mar 6, 2026
@bholmesdev bholmesdev changed the title SEO/AEO audit: add site URL, robots.txt, structured data, and improved meta descriptions feat(www): SEO/AEO audit — site URL, robots.txt, structured data, improved meta Mar 10, 2026
@bholmesdev bholmesdev changed the title feat(www): SEO/AEO audit — site URL, robots.txt, structured data, improved meta feat(www): SEO/AEO audit — sitemap, robots.txt, structured data, improved meta Mar 11, 2026
@bholmesdev bholmesdev changed the title feat(www): SEO/AEO audit — sitemap, robots.txt, structured data, improved meta SEO/AEO audit: improve titles, descriptions, structured data, and crawlability Mar 16, 2026
@bholmesdev bholmesdev changed the title SEO/AEO audit: improve titles, descriptions, structured data, and crawlability SEO/AEO audit: site URL, robots.txt, structured data, improved descriptions Mar 17, 2026
@bholmesdev bholmesdev changed the title SEO/AEO audit: site URL, robots.txt, structured data, improved descriptions feat(www): SEO/AEO audit and optimizations Mar 18, 2026
- Add site URL (https://simple-stack.dev) to astro.config.mjs enabling
  canonical URLs, sitemap generation, and proper OG meta tags
- Add WebSite + Person JSON-LD structured data for search engine and AI
  engine discoverability
- Add robots.txt pointing to sitemap
- Remove redundant custom title head override on homepage
- Add noindex meta to deprecated pages (stream, form/*) to preserve
  crawl budget
- Add title attribute to video element in stream.md for accessibility

Co-Authored-By: Oz <oz-agent@warp.dev>
@bholmesdev bholmesdev changed the title feat(www): SEO/AEO audit and optimizations feat(www): SEO & AEO audit improvements Mar 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant